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SOFTWARE LICENSE AND COPYRIGHT 


This software is copyrighted and all rights are 
reserved by Quality Computers, Inc. Your use is subject 
to the limitation and restrictions of the copyright laws 
and of this license. 


Permitted Uses 
You MAY: 


1. Use this software on a single computer. 


2. Copy the software for the purpose of backup 
Or convenient access, in the manner de- 
scribed in the manual, in support of your use 
of the software on a single computer. 


Prohibited Uses 
You MAY NOT: 


1. Distribute, rent, sub-lease, lease, or otherwise 
make available to others, the software or 
documentation or copies thereof. 


2. Use the software, or permit it to be used on 
more than one computer workstation at one 
time. 


LIMITED WARRANTY 


This software and documentation are sold “as is”. 
The entire risk as to the quality and performance of the 
software is assumed by the user. 


Quality Computers, Inc. and Apple Computer, 
Inc. make no warranties, either expressed or implied, 
regarding the enclosed computer software package, its 
merchantability or its fitness for any particular purpose. 
In no event shall Quality Computers, Inc. or anyone else 
who has been involved in the creation, production or 
delivery of this software be liable for any direct, inciden- 
tal or consequential damages, such as, but not limited 
to, loss of anticipated profits, benefits, use, or data 
resulting from the use of this software, or arising out of 
any breach of any warranty. The exclusion of implied 
warranties or liability for incidental or consequential 
damages are not permitted by some states. The above 
exclusion may not apply to you. This warranty provides 
you with specific legal rights. There may be other rights 
that you may have which vary from state to state. 


The original purchaser only, Quality Computers, 
Inc. warrants the magnetic diskette on which the soft- 
ware is recorded to be free from defects in materials 
and faulty workmanship for a period of five (5) years 
from the date the software is delivered. If during this 
period a defect in the diskette should occur, you may 
return the diskette to Quality Computers, Inc. fora 
replacement without charge. 
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Chapter 1 


RAMUP Introduction 


Welcome to RAMUP, the quickest and most 
convenient way of running your favorite programs on 
the Apple II series of computers. If this is your first 
attempt to utilize the many advantages of your Apple, 
Applied Engineering, or other ramcard, prepare to be 
launched into an exciting new way of working with your 
computer. A way which will ultimately reduce the 
amount of busywork (disk swapping and etc.) that is 
forced upon many users. 


If you have used a ramdisk before, but have 
never used RAMUP, prepare yourself for a whole new 
level of power. After all, isn’t that what computing is all 
about? Squeezing that extra bit of speed from the 
machine, and making that favorite application run just a 
little bit smoother is what makes computers a challenge. 
You will find a great amount of “squeezing” and 
“smoothing” built right into RAMUP. 


What is RAMUP? 


RAMUP is a complete software interface for your 
ramcard(s) that does the following: 


1) Creates a ramdisk on your ramcard, if 
needed. 


2) Loads itself and your favorite ProDOS 
application programs to your ramcard. 


3) Provides a powerful program selector 
enabling you to quickly switch between 
applications on your ramcard in just seconds! 


4) Manages multiple ramcards. 


o) 


Provides you with status information and 
partitioning to manage your ramcard storage 
space. 
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Autoloads your ramcard from disk if desired. 
7) Backs up or restores your ramcard if desired. 


RAMUP comes ready to load most of the 
ProDOS software currently available. This will enable 
you to get up and running quickly, without any 
programming knowledge. However, RAMUP can be 
configured to meet your exact needs and desires. We 
have designed RAMUP to be as simple as possible by 
limiting the number of configuration steps, but if you 
would like to customize it, you have total control over its 
operations at any time. 


Requirements for using RAMUP 


1) Apple //e, //c, IGS or LASER computer with 
an 80 column card and 128k base memory. 


2) An Apple, Applied Engineering, or Checkmate 
expansion card with at least 512k of ram 
installed. 


3) Any non-copy protected ProDOS software 
package(s). (Most programs available today 
are ProDOS.) 


RAMUP is shipped in 5.25" format, but 3.5" disks 
are available upon request. 


Recommended hardware for using RAMUP 


1) Aramcard with 1-megabyte or more of ram 
installed. 


2) A3.5" disk drive or Hard Drive. 
About This Manual 


This manual is divided into two major sections. 
For the users who do not like reading a long manual 
before they boot a disk, we have provided a chapter just 
for you! “Quick Start” is a short tutorial which steps a 
user through the basics of setting up and using 
RAMUP. 


The second part of this manual is a reference 
guide to each and every option RAMUP has to offer. 
Each section contains information on the advanced, as 
well as basic techniques, regarding its use. These 


pages are helpful for those users who would like to 
configure RAMUP to meet their specific needs. 


This manual describes the operations as you 
would perform them using the 5.25" disk format of 
RAMUP as supplied with your package. If you have a 
3.5" disk or hard disk we recommend you install 
RAMUP to that drive before doing the configuration 
process. Doing this will help you avoid a lot of disk 
swapping necessary during its use. If you only have a 
5.25" drive, please be patient when you are asked to 
swap disks. See “Put RAMUP on other Disk” for more 
information regarding this process. 


Any keyboard commands that are mentioned 
within this text are referenced between greater and less 
than signs, "< >". The character between these can be 
entered in upper or lower case format. When there is 
more than one character to be typed in, each will be 
between its own set of signs. Therefore, if you see 
<RETURNs this indicates for you to press the RETURN 
key, not the individual letters. 


Before We Begin... 


REMEMBER: Make a backup copy of both of your 
RAMUP master disks. RAMUP is 
NOT copy-protected so you may 
quickly and easily make a backup copy 
of your RAMUP Master Diskettes by 
using the ProDOS FILER supplied with 
RAMUP. 


To Backup your RAMUP diskettes: 
1) Boot up your RAMUP Program Diskette. 


2) At the RAMUP Title Screen, press <F> for 
Filer. 


3) Choose <V> for Volume Commands from the 
Filer Main menu. 


4) Choose <C> for Copy a Volume from the 
Volume Commands menu. 


5) Specify the slot and drive for the volume you 
want to copy. This will be the slot and drive 
number where the RAMUP diskette is 
located. Usually this will be slot 6, drive 1. 


6) Next you will specify the slot and drive of the 
disk you want to copy RAMUP to. Usually this 
will be slot 6, drive 2. 


7) Press <RETURNS> to begin copying. 


When the Filer Volume Copy program is finished, 
you will have made a backup of the front side of 
RAMUP. You must repeat steps 5 through 7 two more 
times to make a backup copy of the two other sides of 
the RAMUP disks. If you have any additional questions, 
consult your “Apple ProDOS User’s Manual” for further 
information concerning this process. Once you are 
done making a backup copy, please put the RAMUP 
Master Diskettes away for safe keeping. Use your 
backup copies to run RAMUP. 


Allow us to define some terms before we begin: 


RAMCARD 


lt is assumed that you have already 
purchased and installed a ramcard 
before attempting to use RAMUP. 
The term “ramcara” refers to the 
actual hardware installed in the 
computer to provide it with significant 
amounts of additional memory. It is 
suggested that you have at least 
912k of memory on this card when 
using RAMUP. RAMUP may use 
almost 90k of the ramcard for its own 
files, so while it is possible to use it 
on a smaller card, it is not as 
convenient. 


RAMDISK 





COLD BOOT 


This term refers to the way the 
extended ram on the ramcard may 
be used. When memory is used as a 
ramdisk, the computer is fooled by 
software into thinking that the 
memory is actually a disk drive. 
There are a few big differences 
between a ramdisk and a real disk 
drive, however, and one of them is 
SPEED! The ramdisk has no 
mechanical parts and therefore is 
lightning fast! Another major 
difference is the fact that ramdisks 
lose all of the information on them 
when the power is turned off on your 
computer. 


Ramcards retain their files until a cold 
boot occurs. A cold boot means that 
the power is shut off to CPU and the 
ramcard. Ramcards with battery 
backup (like Ramcharger) retain 
power - therefore saving the files on 
your ramcard - even though you have 
shut off your main computer switch. 
In this manual when we refer to a 
cold boot, we mean power is 
removed from your ramcard and 
RAMUP will have to be reloaded. 


WARM BOOT 


MENU 


APPLICATION 


A warm boot occurs when you boot 
or re-boot through keystrokes or 
programs, in other words the power 
is never shut off. Things like 
<control><open apple><reset>, PR# 
from BASIC, and Boot # from 
RAMUP are examples of a warm 
boot. The files on your ramcard are 
NOT changed during a warm boot. 


RAMUP will provide you with a list of 
applications which have been loaded 
to the ramdisk. This is referred to as 
a MENU. The RAMUP Main Menu 
will allow you to select and enter into 
your favorite applications at the 
lightning fast speed of the ramdisk. 
When you exit the application, you 
will return to the RAMUP menu so 
you’ can choose another application. 


This term refers to any program or 
group of related program files that 
can be loaded and executed by 
RAMUP. Some programs may 
require more than one program file 
be present in order to execute 
properly, or to execute certain 
functions. Such sets of programs 
include AppleWorks, Quicken, and 
Managing Your Money. These sets 


APPLICATION 
DEFINITION 


PARTITION 


of programs and data files are 
collectively referred to as an 
application. 


This term refers to all the information 
regarding the application as it applies 
to RAMUP. The definition contains 
such information as the title of the 
application, size, etc. This also 
contains the vital information such as 
the location where RAMUP is to load 
the application files from, and to, as 
well as each and every filename that 
RAMUP needs to load to the 
ramcard. This is how RAMUP is able 
to do its job and take all of the busy 
work out of using a ramcard. 


When your ramcard is being used 
entirely as a ramdisk (for storage 
space like a disk drive), it is 
impossible for programs that 
recognize the additional ram to use it 
as computer memory. However, it is 
possible to use a portion of the 
ramcard for a ramdisk while the rest 
is devoted to program use. We do 
this by partitioning the software being 
used. Just as a partition might divide 
a room into two separate parts, a 
software partition will divide a 


SOURCE 


TARGET 





ramcard into a ramdisk and software 
memory. 


This is defined as the location where 
RAMUP will load applications files 
FROM. This may be a 5.25", 3.5", or 
a Hard-Disk. RAMUP will load any 
ProDOS application that is non-copy 
protected. 


This is defined as the location where 
RAMUP will load applications files 
TO. The target volume for RAMUP 
Is always a ramdisk. 


SOURCE 


BACKUP/ 
RESTORE 


If you choose to store anything on 
your ramdisk, you will want a quick 
and easy way of saving that data ina 
safe place. The Backup/Restore 
program that comes with RAMUP will 
make a quick and neat backup of 
your ramdisk. Remember, all 
computer medias (floppy disk, hard 
disk, ramdisk,...etc.) can fail. It is 
important to have all of your 
important data in at least two places 
at once! 
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Chapter 2 


QUICK START 


This chapter is intended for those people who 
hate to read long manuals before attempting to use a 
product. It is designed to run a user through only the 
essential steps needed to get RAMUP “Up and 
Running”. Not all screen prompts or actions are 
mentioned here. You will need to follow these steps, as 
well as follow the on screen prompts. However, if you 
are confused or stuck during a part of the configuration, 
just refer to the next chapters which describe each 
feature and utility in detail. 


Configuring RAMUP 


Before using RAMUP you must go through a 
configuration process. The configuration process 
consists of two steps: 1) Answering the configuration 
screens, and 2) Preparing a RAMUP DATA.FILE. This 
process need only be done once, however you may 
change the configuration at any time. 


NOTE: _ If you have a 3.5" disk or hard drive we 
recommend you install RAMUP to that drive 
before doing the configuration process. 
Doing this will help you avoid a lot of disk 
swapping necessary during the process. 
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Follow these step-by-step instructions: 


Boot the RAMUP disk. You may do this by 
placing the front side of the RAMUP program 
diskette in the first floppy drive and turning on the 
power. After a short amount of time the RAMUP 
title screen will appear. The title screen lists an 
inventory of items installed in your computer. 
Below the inventory is a short menu. 


Press <C> to configure RAMUP. This will take 
you immediately to a set of configuration ques- 
tions. 


The first question is: 


Do you want BASIC loaded onto the 
RAMDISK? 


If you are planning on running BASIC programs 
on the ramdisk, you have little choice but to 
answer YES to this question. If you will not be 
using BASIC programs you may answer NO to 
this prompt and save 10k of ramdisk space. 
The second question is: 

Which of these volumes are RAMDISKS? 


A list of ProDOS volumes will be presented 
below the question. You may use the up and 
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down arrow keys to select the volumes you know 
to be ramdisks. (They usually have names like 
RAM or RAM5.) Use the right arrow key to mark 
a volume (you may mark several if you have 
multiple ramcards/ramdisks). Do NOT select 
“RAMUP"” as a ramdisk. This is the RAMUP 
program volume in your disk drive, not a ramdisk! 
When you have finished selecting ramdisks from 
this list, press the <ESC> key and answer <Y> 
for yes at the safety prompt (“Are you finished 
selecting?”). 


If you have selected more than one volume as a 
ramdisk in the previous question you will be 
presented with a third question. 


Which of these volumes do you want RAMUP 
installed on? 


A list of ProDOS volumes will appear below the 
question. The volume that you choose is the one 
that will have the RAMUP program files loaded to 
it at boot time. There is no clear choice here, but 
there are soine guidelines that can be helpful in 
making your choice: 


A) If you have a ramcard that has battery backup 
you will probably want RAMUP installed on 
that one to reduce boot time. 


B) You may want RAMUP installed on the 
largest ramcard since it takes up 90k. 
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Simply highlight the volume with the up or down 
arrow keys and press <RETURN>. 


Preparing a RAMUP DATA.FILE 


RAMUP comes complete with a database which 
contains application definitions of many of the most 
popular Apple programs. This database takes up more 
than 55k (111 blocks) of disk space and will probably 
contain definitions of many of the programs you will 
want to run with RAMUP. It also will undoubtably 
contain some definitions which you will have no need 
for. Because of this, RAMUP requires you to prepare 
your own customized database called a RAMUP 
DATA.FILE. By doing this we can save valuable space 
on the ramdisk and avoid menus cluttered with prompts 
for applications that are never used. 

When you prepare a DATA.FILE, you are 
actually creating a subset of the full RAMUP database. 
This subset contains the definitions of the group of 
programs that you want to use with RAMUP. You 
create and edit this subset with the utilities on the back 
side of the RAMUP program disk. 


To prepare the DATA.FILE follow these instruc- 
tions: 


1) ‘If you have just finished answering the 
configuration questions you will already be at 
the RAMUP title screen. If not, you must get to 
the title screen by booting the RAMUP program 
disk. 
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4) 


9) 





6) 


On the title screen you will see a prompt for the 
utilities. Press the <U> key. You will be 
prompted to insert the file “RUTIL.SYSTEM"”. 
This file is on the back side of the RAMUP 
program disk. Please remove the RAMUP 
distribution disk, turn it over, and insert it into 
the same drive. Press the <RETURN> key. 


In a short while the Utilities Menu will appear. 
Select the “Add from RAMUP Database” 
option. The first screen displays information 
about the utility and will optionally let you abort 
to the menu screen. 


Press <Y> and <RETURNs> to enter the utility 
after you have read the screen. 


You will be prompted to insert the database 
disk. Please insert the DATA.BASE distribution 


Ta] yo disk into the same drive that you had the 
O 
a_i 


RAMUP program disk in and press 
<RETURN>. 


In a few seconds a screen will appear that has 
a list of several popular applications programs. 
You may browse the list by using the up and 
down arrow keys. Select the applications you 
will be using with RAMUP with the right and left 
arrow keys. 
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8) 


ow 
Fone” 


9) 


10) 


=) 





As an example, there are several different ver- 
sions of AppleWorks listed at the beginning of 
the database. Since most people only use one 
version of AppleWorks you could select the one 
you wish to use by highlighting it on the menu 
and pressing the right arrow key. An arrow will 
appear to the left of the item to indicate that it 
has been selected. 


When you have selected all of the items from 
the database that you want to use with RAMUP 
you may press the <ESC> key and press the 
<Y> key and <RETURN> at the safety prompt. 


A screen will appear asking for the file 
“RAMUP.SYSTEM”. This file is on the front 
side of the RAMUP program disk. 
Please insert the RAMUP disk and 
J press <RETURN>. 


| RAMP 
x 


If this is the first time you have used “Add from 
RAMUP Database”, a new DATA.FILE will be 
created for you. Ifa DATA.FILE already exists, 
your database selections will be appended to 
the existing file. A message will appear notify- 
ing you that the programs were successfully 
added. Press any key to continue. 


Yet another screen will appear asking you to 


insert the RAMUP utilities disk. Please insert 
the back side of the RAMUP distribution disk 
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and press <RETURN>. This will take you back 
to the Utilities Menu. 


lf you later find that you have added something to 
the DATA.FILE that you really didn’t want, DON’T 
PANIC. There are additional utilities for deleting and 
modifying the applications definitions you have just 
added. These will be covered in the utilities section of 
this manual. 


If you have successfully completed the configura- 
tion and have prepared a DATA.FILE, then RAMUP is 
now ready to use on your computer! You may select 
Exit to Title Screen to exit from the Utilities Menu. You 

will be prompted to insert the 


\ ‘RAMUP.SYSTEM*' file. This file is 
allen! located on the front side of the 
4 RAMUP program diskette. Please 


insert the proper side of the diskette 
into the drive and press any key to continue. 


Entering RAMUP 


Now that the configuration is finished, RAMUP 
will be quite easy to use from here on out. Simply boot 
the RAMUP disk and press the <RETURN> key at the 
RAMUP title screen. RAMUP will prepare the ramdisk 
for use (if necessary) and load the RAMUFP files to the 
ramdisk. 

After the RAMUP files are loaded to the ramdisk 
the RAMUP application menu will appear. This is the 


18 


menu from which you will be able to easily run your 
applications on the ramdisk. For now, however, there is 
only a set of default items on the menu. These defaults 
represent the utilities available from the RAMUP Main 
Menu. They will be described later in this manual. The 
programs which you selected while preparing the 
DATA.FILE do not appear on this menu because they 
have not yet been added to the ramdisk. 

The following instructions will step you through 
adding a program to the RAMUP Main Menu: 


1) Select *Add an Application from the RAMUP 


Main Menu. 


av 


A menu will appear on tne right hand side of the 
screen with all of the programs you selected 
while preparing the DATA.FILE. You may select 
the applications you wish to install to the ramdisk 
by using the right and left arrows. An arrow will 
appear to the left of the selected items. 


NOTE: You may also notice the percent of ram used 
graph move when you select items. This 
graph gives you an estimate of how much 

/\ room will be left on the ramdisk after installa- 
tion. 


3) Press the <ESC> key when you have finished 
selecting programs to load and answer YES to 
the safety prompt by pressing the <Y> key and 
<RETURN>. 


19 


4) RAMUP will prompt you for the diskettes neces- 
sary to copy the programs you have selected 
onto the ramdisk . Please insert them one ata 
time until RAMUP is finished. 


NOTE: 


RAMUP uses two different prompts to ask for 
another disk depending on the circumstances. 
lf RAMUP fails to find the volume name that 
the program is normally found on it will 
display a prompt asking for that volume. At 
this prompt, you may optionally type in an 
alternate pathname (if you have copied the 
software to a different disk, for instance). If 
RAMUP finds the correct volume or 
pathname, but cannot find the particular file it 
is looking for, it will display a prompt asking 
for the full pathname (including the filename). 


5) When all of the selected programs are fully 


copied to the ramdisk, RAMUP will return to the 
applications menu. This time you will notice that 
your applications have been added to the top of 
the menu. 


Using RAMUP 


Once your applications are loaded to the ramdisk 


you may switch between them quickly and easily. Sim- 
ply select your application from the menu. When you 
are finished with the application, and you exit it, you will 
be returned to the RAMUP Main Menu. 
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You are now done setting up RAMUP in the 
quickest and easiest way possible. However to benefit 
from all of the features RAMUP we recommend that you 
read the rest of this manual. 
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Chapter 3 


RAMUP Title Screen 


This is the first screen that appears once the 
front side of the RAMUP Program disk has been 
booted. You may get to this screen by placing the front 
side of the RAMUP program diskette in the first floppy 
drive, usually marked drive A, and turning on the power. 
After a short amount of time the RAMUP Title Screen 
will appear. You will notice a description of your system 
under the RAMUP title on the screen. This will not 
always give the most accurate description, depending 
on the age of your peripheral card. If it is, older or very 
new, this program will probably not recognize it. In this 
case, you will see the message, “unknown card type”. 





NOTE: Ramfactor users - don’t worry if RAMUP says 
“unknown card type” displayed in that slot. 
This is because of a special identification 
technique used by this card. RAMUP will still 
recognize the card when it is run. 


Under this system description you will find a 
selection menu that can be used to enter the different 
parts of RAMUP. This screen should look somewhat 
like the following: 


Z2 


tm 
RAMUP 4.0 
As of : XX/XX/XX 


Contents 


Serial Port/ AppleTalk Port 

Serial Port/ AppleTalk Port 

Apple 80 Column Card 

Mouse Port 

UnWDisk 3.5 inch Disk Port/SmartPort 
lIIGS Disk Port 

Unknown Card Type 


[Return] to enter RAMUP 
[B] to enter BASIC 
[F ] to use the filer 
[C] to Configure RAMUP 
[U] to use the Utilities 
[R] to Restore/Backup a volume 


Copyright (c) 1988 by Quality Computers, Inc. All Rights Reserved 
Created by Joe Gleason Rewritten by Walker Archer and Tony Fadell 





The options work as follows: 
[RETURN] to enter RAMUP 


This option enables you to enter the RAMUP 
program. It follows the following steps: 


1) It checks for a ramcard that needs a ramdisk 
driver. If one is found it executes the 


RAM.DRIVE program found on the front side of 
the RAMUP program disk. 


2) It reads in the RAMUP.CONFIG file for informa- 


tion regarding the number of ramcards and 
names of ramdisk volumes. 
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3) It checks to see if RAMUP has been previously 
installed on the ramdisk. If not it proceeds to 
install the RAMUP system files. During this 
process it will patch the ProDOS 8 quit code so 
that any subsequent calls to it will return the user 
to the RAMUP Main Menu. 


4) It checks to see if an auto-load configuration has 
been saved. If it has been, RAMUP will prompt 
for each of the applications required to set-up the 
previous Main Menu. 


lf your ramcard has already been loaded with RAMUP, 
pressing <RETURN> will display the RAMUP Main 
Menu. The Main Menu is explained further in the next 
section of this manual. 


[B] to enter Basic 


Pressing <B> will take you to Applesoft BASIC. 
This will allow you to escape RAMUP and execute 
another program from the BASIC prompt “}]” or do some 
programming. Whatever you would like to do here you 
can always get back to RAMUP. Make sure the front 
side of the RAMUP program disk is inserted and type 
“BYE” and <RETURN> at the Applesoft prompt “]”. 
You will then be returned to the RAMUP Title Screen. 


[F] to use Filer 


This is a quick way to access a file utility to take 
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care of all of your disk maintainance. The Filer program 
is Apple’s utility for disk maintainance. By pressing <F> 
you will enter the Filer program. Refer to your “Apple 
ProDOS User’s Manual” for more information regarding 
this programs use. 


If you would rather use a different file utility it is 
possible to load that utility in place of the Apple Filer. 
Simply replace the file named "FILER" on the front side 
of the RAMUP disk with the program that you want to 
use. For instance, if you want to replace the filer with 
Copy II Plus: 1) Delete the "FILER" program from the 
RAMUP disk. 2) Copy the "UTIL.SYSTEM" file from 
Copy II Plus to the RAMUP disk. 3) Rename the 
"UTIL.SYSTEM'" file on the RAMUP disk to "FILER. 


[C] to Configure RAMUP 

Pressing <C> will present the series of configura- 
tion screens which RAMUP needs to run. You can use 
this option to reconfigure RAMUP as many times as 
desired. 

The configuration information is stored in the 
RAMUP.CONFIG file which will be created in the 
WORKSUB subdirectory of the boot drive. (See 
Configuring RAMUP). 

[U] to use the Utilities 


This is the only way of entering the RAMUP 
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Utilities. By pressing <U> you will be presented with 
the RAMUP Utilities Menu. You may see a prompt 
asking you to insert the RAMUP Utilities disk. The 
utilities are located on the reverse side of the RAMUP 
program disk. You will need to turn the disk over and 
press any key to continue. See the RAMUP Utilities 
chapter in which each of these utilities are explained. 


[R] to Restore/Backup a Volume 


Pressing <R> will allow you to quickly access the 
Backup/Restore program. Refer to the next chapter for 
more information regarding this utility. 


NOTE: Backup/Restore is also located on the 
RAMUP Main Menu. The usual procedure is 
to Restore from the RAMUP Title Screen - 
and Backup from the RAMUP Main Menu. 
Backup and Restore are explained in detail in 
the RAMUP Main Menu section of this 
manual. 
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Chapter 4 


RAMUP Main Menu 


The Main Menu appears after “[RETURN] to 
enter RAMUP’” is selected from the Title Screen. Itis 
divided into left and right halves. The right half shows 
you how much of the selected drives are currently in 
use. The graph gives a percent estimate of how much 
memory is left on all of the selected ramcards collec- 
tively. Below the graph is a list of the drives (volumes) 
you selected in the configuration procedure along with 
the number of blocks free for each volume. 


The Main Menu will initially contain the following op- 
tions: 


Pye ae 
par Die iy 0 bee RADU) 
* Delete an Application 
*¥Save Auto-load Config 


Filer 
Installed Drtve Blocks L 
Backup /Restore ————— eee 
RAM 1511 


RAMS 1325 


Use the arov keys to highlight a program: RETURM to select 
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NOTE: The number of Boot items at the bottom of 
the menu will depend on the devices installed 
in your computer. RAMUP will only display 
Boat items for slots that contain bootable 
drive controllers. This may cause some 
confusion if you do not have a drive con- 
nected to the controller. For instance, a //c 
with 3.5 ROMS will display a Boot 5, whether 
or not a 3.5" disk drive is connected to the 
drive port. 


To select options in the Main Menu use the up and 
down arrow keys to highlight your choice and press 
<RETURN3> to execute the choice. 


* Add an Application 


* Add an application is used to load applications 
listed in your DATA.FILE to your ramcard and then list 


those applications on the Main Menu. 


1) Select *Add an application from the RAMUP 


Main Menu. 


2) Amenu will appear on the right hand side of the 
screen with all of the programs you selected 
while preparing the DATA.FILE. You may select 
the applications you wish to install to the ramdisk 
by using the right and left arrows. An arrow will 
appear to the left of the selected items. 


28 


iL Lal : Pe ee PO 


* Add an Application 

* Delete an Application 
¥Save Auto-load Config 
Filer 

Backup /Restore 


Boot 6 
Boot 7 Copy II Plus 


Ascii Express 
AppleWriter 
-> TimeOut QuickSpell 





Use the aroy keys to hihiigh! a program: RETURN to sekct 


NOTE: You may also notice the percent of ram used 
graph move when you select items. This 
graph gives you an estimate of how much 
room will be left on the ramdisk(s) after instal- 
lation. 


3) Press the <ESC> key when you have finished 
selecting programs to load and answer YES to 
the safety prompt by pressing the <Y> key and 
<RETURN>. 


4) RAMUP will prompt you for the diskettes neces- 
sary to copy the programs you have selected 
onto the ramdisk. Please insert them one ata 
time until RAMUP is finished. 
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NOTE: RAMUP uses two different prompts to ask for 
another disk depending on the circumstances. 
If RAMUP fails to find the volume name that 
the program is normally found on it will 
display a prompt asking for that volume. At 
this prompt, you may optionally type in an 
alternate pathname (if you have copied the 
software to a different disk, for instance), or if 
RAMUP finds the correct volume or 
pathname, but cannot find the particular file it 
is looking for, it will display a prompt asking 
for the full pathname (including the filename). 


5) When all of the selected programs are fully 
copied to the ramdisk, RAMUP will return to the 
applications menu. You will notice that your 
applications have been added to the menu. 


If an error occurs during the copying process, make a 
note of it and continue to load the ramdisk. Errors can 
occur here for a number of reasons: damaged floppy 
disks, not enough memory on the ramcard, or problems 
with the database description. The first thing you 
should try if such a problem occurs is to copy the file 
that would not copy using the filer program. This should 
give you some clues as to the soundness of your source 
diskettes. The utilities will be helpful in finding out if the 
database description is causing RAMUP to look fora 
file that does not exist or is on a different disk. 
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*Delete an Application 


Occasionally you may want to free up some of 


the space being used by applications on your ramdisk in 
order to make room for more data or a different applica- 
tion altogether. You may remove applications from the 


ramdisk by using the *Delete an Application option. 


Follow these step-by-step instructions: 


1) 


2) 





Select “Delete an Application from the RAMUP 
applications menu. 


A menu will appear on the right hand side of the 
screen with all of the programs currently on the 
ramdisk listed. You may select the applications 
you wish to delete from the ramdisk by using the 
right and left arrows. An arrow will appear on the 
left of the selected item. 


YE | 0 sae pe) Fett. ISS Wo Sh ais 


AppleWorks 

Copy II Plus 

Ascii Express 

* Add an Application 

*® Delete an Application 
¥Save Auto-load Config 
Filer 

Backup/Restore 

Boot 6 

Boot 7 


AppleWorks 
Copy II Plus 


Use the arow keys to hihilant a program: RETURM to select 
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NOTE: You may also notice the percent of ram used 
graph move when you select items. This 
graph will give you an estimate of how much 
room will be left on the ramdisk(s) after the 
deletions. 


3) Press the <ESC> key when you have finished 
selecting programs to load and answer YES to 
the safety prompt by pressing the <Y> key and 
<RETURN>. 


4) RAMUP will delete all of the files which it copied 
onto the ramdisk, and if no additional files were 
created, the subdirectory that contains the appli- 
cation will also be deleted. 


When all of the related files have been deleted 
you will be returned to the applications menu. 


= 


* Save Auto-Load Config 


Selecting this option will modify the DATA.FILE 
on your boot disk so that RAMUP knows which 
applications to load automatically. All you need to do is 
load the ramdisk with the applications you want to use 
on aregular basis. Then select the * Save Auto-Load 
Config option. Choosing the option at this point will 
change the DATA.FILE items for everything on the 
menu. Next time you boot RAMUP you will be 
automatically prompted to insert the disks for each of 
the applications currently on the menu. 
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Choosing *Save Auto-Load Config from the 
menu is like saying, “Now that | have the ramdisk set up 
just the way | like it, let’s set it up this way every time we 


boot.” 


Follow these steps: 


1) Select “Save Auto-Load Config from the 


RAMUP applications menu. 


2) Answer YES to the safety prompt (“Are you 


sure’?”) by pressing the <Y> key and 
<RETURN>. 


If you do not have the RAMUP boot disk in 
the drive, you will be asked to insert it. Press 
RETURN once you have done this. 


4) You will be returned to the RAMUP applica- 


tions menu. No changes will be apparent 
until you boot next time. Then all of the 
current applications will automatically be 
copied back onto the ramdisk. 


If you have a ramdisk with battery back- 
up, Or multiple ramdisks with a combination of 
battery back-up and non-battery back-up, 
RAMUP will automatically check each volume 
to make sure it doesn’t copy things that are 
already loaded. 
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NOTE: This option does not save data files created 
during the process of using programs on the 
ramdisk or files copied to the ramdisk with a 
copy program. Only the application files will 
be restored. See the BACKUP/RESTORE 
topic for an easy way of saving and restoring 
everything on the ramdisk. 


FILER 


This is a quick way to access a file utility to take 
care of all of your disk maintainance. The Filer program 
is Apple’s utility for disk maintainance. By pressing 
<RETURN3> on this option, you will enter the Filer pro- 
gram. Refer to your “Apple ProDOS User’s Manual” for 
more information regarding this programs use . 


BACKUP/RESTORE 


The Backup/Restore program will make a quick 
and easy image backup of your ramdisk (or any other 
ProDOS volume you may want to back-up). The 
backup function will effectively save your ramdisk to 
another volume. The restore function will put the ram- 
disk back in place just like it was when you did the 
backup. An image backup is an exact copy of all of the 
blocks on a volume that are used. No blank blocks are 
copied into the backup, and files are not directly acces- 
sible from the backup until a restore is done. You can 
think of this type of backup as having a picture taken of 
your ram disk. The next time you restore the backup to 
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the ramdisk, it will look just like it did when you did the 
backup. 


Highlight Backup/Restore and press <RETURN3>. 
Use the up/down arrow keys to highlight BACKUP or 


RESTORE and press <RETURN>. 


If you select the backup option the menu will ask 
you to select the SOURCE drive (the drive to be backed 
up). 


Use the up/down arrows to highlight the 
SOURCE volume (your ramcard) and press 
<RETURN>. The menu will then ask you fora 
DESTINATION drive. Enter the DESTINATION slot and 
drive number. 


NOTE: About 7 - 5.25" diskettes or 2 - 3.5" diskettes 
are required per megabyte of ramcard to be 
backed up. Diskettes MUST be formatted 
before being used for backup. Be sure you 


have enough FORMATTED diskettes on hand 
before beginning. 


Backup will create a file or files on the 
DESTINATION drive called “Backup.disk.1” for the first 
disk, “Backup.disk.2” for the second, etc. Label your 
disks carefully. You will need to insert them in the 
correct order to restore. 

If you select the restore option the menu will ask 
you for a SOURCE slot and drive number (the place 
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where you will insert your disks: Backup.disk.1, 
Backup.disk.2, etc). You will then select the 
DESTINATION slot and drive number for your ramcard. 
A prompt at the bottom of the screen will tell you which 
disks to insert in the SOURCE drive and when. 


WARNING: Restore will overwrite all files on the 
DESTINATION disk. Make sure you have 
copied or backed up the current files on the 
DESTINATION before restoring. 


This function can make it very easy to load your 
ramdisk when booting RAMUP at the beginning of a 
session. Restoring an image backup is much faster 
than loading software using * Add an application. This 
same Backup/Restore program is also available at the 
RAMUP Title Screen. 


Since the backup produced by this utility is an 
image file, you cannot restore the backup to a larger 
volume. Although the restore will work and all of the 
files will appear on the restored disk, it will be the same 
size as the disk that was backed-up. In the case of 
restoring to a smaller volume, you may get errors if 
some of the blocks being restored are beyond the 
number of blocks available to the smaller volume. In 
any case, the size of the volume will not match after the 
restore. 


some hard drives use files with a file-type of BAD 
in order to mark bad sectors. If you use this program to 
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make a backup of such a drive, errors will occur on 
these BAD files. This is considered normal and the 
backup will continue when you press any key. (This 
should not be considered normal for hard drives that do 
not use this method. For such drives you should con- 
tact your dealer to test the drive.) When you restore the 
backup you must restore it to the same hard disk so that 
the bad blocks will be overlaid onto the same spots. 


BOOT # - (Re-boot from any drive) 


When RAMUP starts it looks at all available 
drives and lists them at the bottom of the RAMUP Main 
Menu. The number of listings depends on how many 
drives your computer has installed. Highlight any drive, 
press <RETURN>, and your computer will re-boot using 
the highlighted drive. 


NOTE: It is assumed by RAMUP that all connected 
drives are bootable. Some are not on certain 
computers or may not contain disks with the 
appropriate files to boot. 


You may need to experiment with your particular 
computer system to determine which drives and disks 
can be booted.You can use <ctrl><open apple><reset> 
to re-boot the computer from the keyboard or PR#n 
(where n is the slot you wish to boot) from the BASIC 
prompt “J”. 
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Chapter 5 


RAMUP Utilities 


The RAMUP Utilities Menu contains many utili- 
ties to help you setup or modify RAMUP to suit your 
specific needs. Each of these utilities is described in 
detail on the following pages. Also included are hints 
and tips to help you use the utilities to make RAMUP 
take away more busy work than you ever thought pos- 
sible! 





To enter this menu, just boot up the RAMUP 
program disk. At the RAMUP Title Screen, press <U> 
to enter the Utilities Menu. You may be asked to insert 
the RAMUP Utilities disk, if so, the Utilities disk is found 
on the backside of the RAMUP program disk. The 
RAMUP Utilities Menu appears as follows: 


RAMUP: Utilities Menu by Anthony Fadell Copuriqht (C) 1988 Quality Computers 


Add trom Pat wir Cat stare 
Add an Undefined Program 
Delete a Pogram 

Modify a Program 

Convert 3.0 Program 
Partition a RamCard 

View the Help Files 

Put RAMUP on other disk 
Exit to Title Screen 





Use the arrow keys to highlight a utility. ‘RETURN’ when finished 
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To execute a utility, highlight the utility you wish 
to use with the up/down arrow keys and press 
<RETURN>. The Exit to Title Screen option will return 
you to the RAMUP Title Screen. 


Add from RAMUP Database 


Add from RAMUP Database allows you to add 
applications to your DATA.FILE from the application 
definitions sup- 
plied on your 
DATA.BASE 
diskette. This 
is the quickest 
and easiest way 
for you to tell 
RAMUP what ap- 
plications you 
would like to load 
to your ramcard. 
The application 
definition in the 
DATA.BASE follows the exact file format that is 
released for the application from the manufacturer. This 
means that RAMUP should load your application's 
master diskettes as supplied from the manufacturer. 
However, if you don't see an application on this list that 
you would like to load to the ramcard or your application 
doesn't fit the same file description as the DATA.BASE, 
DON’T worry! You may use the Add an Undefined 


Program or Modify a Program to make these programs 
load and run using RAMUP. 


DATA.BASE 


APPLEWORKS 
APPLEWRITER 


DATA.FILE 
ASCII EXPRESS 


COPY II PLUS 
MULTISCRIBE 
PRINT SHOP 


APPLEWORKS 
COPY Il PLUS 





RAMUP PROGRAM DISK DATABASE DISTRIBUTION 


DISK 
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When you first enter Add from RAMUP. Database 
you will be presented with a text screen containing 


notes about the program and a prompt allowing you to 
proceed or escape from this utility. To execute this 
utility, press <Y> and <RETURN>. If you do not wish to 
run this utility, press <N> and <RETURN> and you will 
then be returned to the RAMUP Utilities Menu. 


=~ aa The program will now look to your 
ee disk drives to find the DATA.BASE 
Distribution diskette supplied with your 

RAMUP package. Insert this disk into a drive and press 
any key at the prompt to continue. Add from RAMUP 
Database will now read all of the possible pre-defined 
applications you can select to add to your DATA.FILE. 
You will be presented with a menu containing this 
listing. Use the up/down arrows to scroll and the right/ 
left arrow keys to mark/unmark the applications you 
want RAMUP to work with. When you have selected all 


of the files that you wish to load to the ramcard, press 
<ESC>. 


NOTE: _ If you don’t see any applications you wish to 
select from this list, make Sure no applications 
are selected and press <ESC>. You will be 
returned to the RAMUP Utilities Menu. 


lf you have made sure you have selected all the files to 
add, answer <Y> and <RETURNs> at the prompt to 
continue. If you've forgotten some files or marked one 
by accident, just answer <N> and <RETURN> and you 
will be returned to the selection process. 


40 


After you have finished selecting the applications, 
if this utility finds a DATA.FILE already in existence, it 
will automatically append the selected applications to 
the current list. However, if no DATA.FILE was found, 
Add from RAMUP Database will create this file to 


a] enable you to run RAMUP. Follow the 
oe prompts the utility gives you for disk 
“EEE swapping. Note, at one point during the 
installation process, Add from RAMUP Database may 
ask you to insert the disk containing RAMUP.SYSTEM. 
This is found on the front side of the RAMUP program 


diskette. If you see this prompt, insert the correct disk 
and press any key to continue. 





NOTE: Remember that you are creating or modifying 
DATA.FILE which can contain a maximum of 
26 listings. If you had a pre-existing 
DATA.FILE before using this utility, remember 
not to select any more than you have room for 
inthe DATA.FILE. For example, if you hada 
pre-existing DATA.FILE with 20 applications 
installed, you cannot select any more than 6 
additional applications. In this case, if you 
were to select more than 6 applications, let's 
say 8 applications, only the first six would 
show up on the *Add an Application screen, 
while the other 2 applications would be hid- 
den. 


Once the installation process is complete, you 
will see a prompt stating the installation has been suc- 


4] 


cessful. Press any key and you will be returned to the 
RAMUP Utilities Menu. 


Add an Undefined Program 


Add an Undefined Program is one of the most 
powertul utilities that is supplied with your RAMUP 
package. This utility allows you to add applications or 
data files to RAMUP's DATA.FILE that are not already 
a part of RAMUP’s DATA.BASE. This utility is also 
helpful for those who have definitions for their applica- 
tions that differ with those found in the DATA.BASE. 
For example, this utility will allow you to add an applica- 
tion which could spread out over more than just one 
disk, or if the application is on a hard disk. 


When you first select Add an Undefined Pro- 
gram from the Utilities Menu, you will be presented with 
a text screen containing notes and a prompt allowing 
you to execute or escape this utility. To execute this 
utility, press <Y> and <RETURN>. If you do not wish to 
run this utility, press <N> and <RETURN> and you will 
then be returned to the RAMUP Utilities Menu. 


NOTE: _ This utility may ask you to insert the disk 
containing the RAMUP.CONEFIG file. This file 
can be found on the front side of the RAMUP 
program diskette. Insert this diskette into the 
drive and press a key at the 
prompt. If this utility still prompts ml 
you to insert this disk, you must 5 
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run the RAMUP configuration program. See 
the “RAMUP Configuration” section of this 
manual for more information regarding this 
process. 


At the next screen you will type or select the 
information concerning this application. To use this 
screen use the up/down arrow keys to select the line 
you wish to edit. If you look at the bottom of the screen 
it will tell you which keys you can use to input informa- 
tion. 


At the first line you can type the title of the appli- 
cation. You may type up to 25 letters, numbers, or 
other characters. This title will show up on the “Add an 
Application” menu. 


On the next line, if you have more than one 
ramcard you will be able to select which of these 
ramcards you would like RAMUP to load and execute 
the applications you are adding. Use the left/right arrow 
keys to select the volume where RAMUP will load this 
application. If “NONE” is selected, RAMUP will select 
the first ramcard with adequate space to load the appli- 
cation for you. This option is especially helpful if you 
have one battery backed-up ramcard or romdisk and a 
volatile ramcard. You may want to put the applications 
that you always load to the battery backed-up ramcard, 
while only loading the infrequent applications to the 
volatile ramcard. This will enable you to have free ram 
left on your romdisk to save your most used data files. 
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The “Video Mode” option is the next selection on 
this screen. Use the left/right arrow keys to set this 
option accordingly. Most programs today are 80 col- 
umns (ie. AppleWorks, Quicken, and various other text 
programs). However, if you are using graphics applica- 
tions such as Multiscribe or Publish It! this option should 
be set to 40 columns. If you have any questions you 
should consult your owners manual of the applications. 
Remember: text applications are 80 columns while 
graphic applications are 40 columns. 


a When you have finished specifying 
oe the information on this screen, insert the 

“BEE diskette which contains the files you wish 
RAMUP to load to your ramcard. This diskette will be 
defined as the Source volume. Once you have the disk 
ready, press <ESC> to move to the file selection 
screen. You will now see a menu containing a listing of 
all volumes on-line (See NOTE). Highlight the Volume 
name of the source diskette by using the left/right arrow 
keys. When you have selected the proper choice, press 
<RETURN>. 





NOTE: _ If your files are found in a subdirectory, 
instead of the volume directory, you may 
select “Specify a Path”. At the prompt, type in 
the location of the files. Remember, when 
specifying a path, be sure to have slashes "/" 
beginning and ending the path. When finished 
press <ESC> to move to the next screen. 


At the next screen you will specify the target 
pathname for ihe application files you wish to load from 
the source volume you specified above. RAMUP will 
create this path on your ramcard and then copy the 
application files into it during the loading process. You 
may notice a volume name already present on this 
screen, this is the volume name you specified in the 
volume preference option at the beginning of Add an 
Undefined Program. If you selected “NONE” at this 
option, the volume name will default to 
“(VOLUMENAME?’”. This only means that RAMUP will 
select the volume for you. If you selected an actual 
volume for this option the name will appear here. You 
cannot change or modify this volume name, but don’t 
worry, if this selection is not correct you can use Modify 
a Program to change this option quickly and easily. 
Now type in the target pathname, remember that 
slashes “/" must begin and end this pathname. When 
finished, press <ESC> to move to the next screen. 


Now you will be presented with a list of files that 
RAMUP can load from the Source volume or path. 
Select every file you would like to load from that Source 
volume or path by using the up/down arrow keys to 
highlight a file. The right/left arrow keys are used to 
mark/unmark all the files required. 


NOTE: You do not have to select the files, ProDOS 
or BASIC.SYSTEM. RAMUP automatically 
loads and runs these files at the appropriate 
times. 
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When you have finished selecting, press <ESC>. 
lf you have made sure you selected all the files, answer 
<Y> and <RETURN> at the prompt to continue. If you 
forget some files, just answer <N> and <RETURN> and 
you will be returned to the selection process. 


Some applications are directly executable while 
others are installed as accessories to other programs. 
At this point you should determine whether the 
application you are adding to the DATA.FILE is directly 
executable or an accessory. 


Executable applications are programs such as 
AppleWorks, Multiscribe, and Quicken, while 
accessories are ones like TimeOut QuickSpell, TimeOut 
Thesaurus, or Pinpoint Desk Accessories. Accessories 
do not generally have an executable file. However, 
when an application is executable, there is always one 
file to be executed first, this file may end with the suffix 
(.system) and is usually found in the catalog right after 
the ProDOS system file. For example, AppleWorks has 
an executable file called APLWORKS.SYSTEM. 
Applications written in BASIC may use a file called 
STARTUP as its executable file. 


NOTE: You may directly execute BAS type files from 
RAMUP (ie. select them as executable files in 
this utility). However, in order for them to 
successfully execute under RAMUP you must 
have selected “YES” for loading 
BASIC.SYSTEM to the ramdisk when an- 
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swering the configuration questions. Using 
RAMUP to execute BASIC programs in this 
manner is much more efficient than loading 
BASIC.SYSTEM for each BASIC application 
and selecting it as the executable file. 


Refer to your application’s users manual for more 
information regarding the executable file. On the screen 
you will see a menu of all of the files you selected from 
the previous screen. Use the up/down arrow keys to 
highlight the executable file for this application and 
press <RETURN>. However, if no executable file exists 
for this application press <ESC>. 


At this point you have finished installing one set 
of files for this application. The next screen asks you 
whether you have finished installing this application. If 
there are more files you need to add for this application, 
or there are more files which are contained on a sepa- 
rate disk(s) press <C> to continue to add files. When 
you choose to continue you will be brought back to the 
source diskette screen where you can choose the 
volume you would like to load programs from. Continue 
with the same instructions as above. However, if you 
have added all of the files necessary for this application, 
press <ESC> and you will be returned to the RAMUP 
Utilities Menu. 


Here are some hints and tips when using Add an 
Undefined Program to maximize your use of RAMUP : 
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1) Use this utility to create an application called, 
“My Data” to copy your data to the ramcard. 


2) Make separate definitions for macro files. 
Database macros can be loaded when you 
only need to use your database program, and 
spreadsheet macros can be loaded when you 
need to use your spreadsheet program. 


3) Before using Add an Undefined Program you 
may want to make a list of files and subdirec- 
tories necessary to run the application. 


Delete a Program 


Delete a Program allows you to remove applica- 
tion listings from DATA.FILE so that you can make 


space available for other listings or remove applications 
that were incorrectly installed. 


When you first enter Delete a Program you will 
be presented with a text screen containing notes about 
the program and a prompt allowing you to proceed or 
escape from this utility. To execute this utility, press 
<Y> and <RETURN>. If you do not wish to run this 
utility, press <N> and <RETURN> and you will then be 
returned to the RAMUP Utilities Menu. 


This utility may ask you to insert the 
aml disk containing the RAMUP DATA.FILE. 
This file can be found on the front side of 
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the RAMUP program diskette. Press any key at the 
prompt to continue. 


NOTE: The DATA.FILE file will be present only if you 
have used the Add from RAMUP Database or 
Add an Undefined Program successfully. If 
you are continually asked to insert the disk 
containing this file after you have inserted the 
proper diskette, the DATA.FILE has not been 
created. Therefore, since there are no pre- 
existing programs in this file the Delete a 
Program utility will not work. 


You will be presented with a menu with all pro- 
grams installed in the DATA.FILE. Use the up/down 
arrow keys to scroll through the files. Use the right/left 
arrow keys to mark/unmark the applications you would 
like to delete. When you have finished selecting, press 
<ESC>. If you have made sure you selected all the files 
to delete, answer <Y> and <RETURN> at the prompt to 
continue. If you’ve forgotten some files or marked one 
by accident, just answer <N> and <RETURN> and you 
will be returned to the selection process. 


The utility will proceed to delete the applications 
from the DATA.FILE. You will notice the prompt “Pro- 
grams have been deleted Successfully,” now press any 
Key and you will be returned to the RAMUP Utilities 
Menu. 
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NOTE: _ If you delete all of the application listings, this 
program will delete the whole DATA.FILE. To 
be able to use RAMUP, a DATA.FILE must 
be created by using either Add from RAMUP 
Database or Add an Undefined Program. 


For more information see the section on 
“DATA.FILE”. 


Modify a Program 


The Modify a Program utility allows you to edit 
program listings found in the DATA.FILE. This utility is 


very useful if you have used the application definition in 
the RAMUP DATA.BASE and need to modify the defini- 
tion to support your 3.5" disk or hard drive. 


When you first execute Modify a Program from 
the Utilities Menu, you will be presented with a text 
screen containing notes and a prompt allowing you to 
proceed or escape from this utility. To execute this 
utility, press <Y> and <RETURN>. If you do not wish to 
run this utility, press <N> and <RETURN> and you will 
then be returned to the RAMUP Utilities Menu. 


This utility may ask you to insert the 
win. disk containing the RAMUP DATA.FILE. 
This file can be found on the front side of 


the RAMUP program diskette. Press any key at the 
prompt to continue. 
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NOTE: This file will be present only if you have used 
the Add from RAMUP Database or Add an 
Undefined Program successfully. If you are 


continually asked to insert the disk containing 
this file after you have inserted the proper 
diskette, the DATA.FILE has not been 
created. Therefore since there are no pre- 
existing programs in this file the utility will not 
work. 





The utility will now read all of the applications 
found in your DATA.FILE. When finished, you will be 
presented with a listing of these applications. Use the 
up/down arrow keys to highlight the application you wish 
to modify and press <RETURN>. 


Modify a Program will read all the information 
concerning the application you selected. The first 
screen you are presented with contains the vital infor- 
mation concerning the entire application such as the 
title, autoload, video mode, volume preference, and 
length. Use the up/down arrow keys to scroll through 
the fields you wish to edit. 


At the first line you can type the title of the appli- 
cation. You may type up to 25 letters, numbers, or 
other characters. This title will show up on the Add an 


Application menu. 


Autoload can be found on the next line. Use the 
left/right arrow keys to toggle YES or NO. If you select 
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YES, this application will become part of your auto-load 
configuration. See “Save Auto-Load Config” for more 
details regarding this option. 


On the next line, if you have more than one 
ramcard you will be able to select which of these 
ramcards you would like RAMUP to load to and execute 
the application from. Use the left/right arrow keys to 
select the volume where RAMUP will load this applica- 
tion. If “NONE” is selected, RAMUP will select the first 
ramcard with adequate space to load the application for 
you. This option is especially helpful if you have one 
battery backed-up ramcard or romdisk and a volatile 
ramcard. You may want to put the applications that you 
always load to the battery backed-up ramcard, while 
only loading the infrequent applications to the volatile 
ramcard. This will enable you to have free ram left on 
your romdisk to save your most used data files. 


The “Video Mode” option is the next selection on 
this screen. Use the left/right arrow keys to set this 
option accordingly. Most programs today are 80 col- 
umns. (ie. AppleWorks, Quicken, and various other text 
programs). However, if you are using graphics applica- 
tions such as Multiscribe or Publish It! this option should 
be set to 40 columns. If you have any questions you 
should consult your owners manual of the applications. 
Remember: text applications are 80 columns while 
graphic applications are 40 columns. 
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The “Length” option is used by the on-screen 
graph to tell you if you'll have enough room to install the 
application on your ramcard(s). Simply type in the 
number of blocks used by this application. You can 
determine this by cataloging the diskette and adding up 
the number of blocks used by each file that will be 
loaded by RAMUP. For more information regarding 
cataloging diskettes and reading the information, refer 
to your “Apple ProDOS Users Manual” 


When you have finished editing this screen press 
<ESC>. You will be presented with another screen 
which contains the file information about this applica- 
tion. Use the up/down arrow keys to toggle through the 
fields. 


On the first line you will specify the source path- 
name for the application files. This is the location where 
RAMUP will load the application’s files from. This may 
be either a volume or an entire path. Be sure when you 
type in the source pathname to have slashes “/” both 
beginning and ending the path. 


On the next line you will specify the target path- 
name for the application files you wish to load from the 
source volume you specified on the above line. 

RAMUP will create this path on your ramcard and then 
copy the application files into it during the loading 
process. You may notice that a volume name is already 
present on this screen. This is the volume name you 
specified in the volume preference option at the 
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specified in the volume preference option at the 
beginning of Modify a Program. If you selected “NONE” 
at this option, the volume name will default to 
“/[VOLUMENAME’”. This only means that RAMUP will 
select the volume for you. If you selected an actual 
volume for this option the name will appear here. You 
cannot change or modify this volume name. Now type 
in the target pathname, remember that slashes “/” must 
begin and end this pathname. 


The following lines contain each filename with a 
file-type to be loaded from the pathname at the top of 
the screen. You may rename any of the files. You 
cannot add or delete files from the definition on this 
screen. If you want to add or delete files you must exit 
this utility, use Delete a Program to delete this applica- 
tion, and then use Add _ an Undefined Program to create 
a definition with the files of your choice. 


To change the file type of each file use the 
<TAB> key to toggle between the filename and the file 
type column (T). Use the spacebar to change this field. 
There are three types of files used with RAMUP: ex- 
ecutable, regular, and optional files. Each are explained 
in detail below: 


E - This is the executable file for this application. You 
may not select more than one “E” file. Some 
applications are executable while others are 
accessories. At this point you should determine 
whether the application you are modifying in the 
DATA.FILE is executable or an accessory. 
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Executable applications are programs such as 
AppleWorks, Multiscribe, and Quicken, while 
accessories are ones like TimeOut QuickSpell, 
TimeOut Thesaurus, or Pinpoint Desk Accessories. 
Accessories generally do not have an executable 
file. However, when an application is executable, 
there is always one file to be executed first, this file 
may end with the suffix (system) and is usually 
found in the catalog right after the ProDOS system 
file. For example, AppleWorks has an executable 
file called APLWORKS.SYSTEM. Applications 
written in BASIC may use a file called STARTUP as 
its executable file. Refer to your application’s users 
manual for more information regarding the 
executable file. If you cannot toggle this field to 
show an “E”, somewhere on this screen another file 
has been marked “E”, just find this file and change it 
to another file type. Then go back to the file that 
should be the executable file and change it to “E”. 


Files marked “F” are indications to RAMUP that they 
must be copied to the ramcard. If RAMUP cannot 
find and load this file to the ramcard, the application 
will not be fully installed, thus RAMUP will not put 
the application title on the Main Menu. These are 
files such as additional program segments or files 
that a program must have to operate normally. If 
such a file was not found by the program it will not 
run properly. 
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? - Files marked “?” are copied to your ramcard if 
available - that is - they are considered optional by 
RAMUP. These are files such as data files, macro 
files, or program segments you wish to load only 
during certain computer sessions. It is also helpful 
for different versions of the same software package. 
lf RAMUP finds the file on the disk it will load it to the 
ramcard. Ifthe file is not found, RAMUP will skip 
over the file and continue loading with the next file. 


If additional files exist within this application’s 
definition, similar screens will follow containing the rest 
of the files. Press <ESC> when you are finished editing 
each screen. When all of the information has been 
shown on the screen, a prompt will appear that the 
modification was successful. Press any key and you 
will be returned to the RAMUP Utilities Menu. 


Partition a RamCard 


Some programs will automatically recognize that 
a ramcard Is installed in your computer and use the 
additional memory. For instance, AppleWorks will 
automatically use the additional memory as desktop 
space on many ramcards. This can be good if you are 
not using the expanded memory for anything else, 
however, if you are using it for a ramdisk (as RAMUP 
does) this can be disastrous. When a program ac- 
cesses the memory in use by the ramdisk it runs a high 
risk of destroying all or part of the contents of the ram 
volume. These types of programs force you to choose 
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whether to use a ramdisk or whether to use the pro- 
gram. 


Ofcourse it RambDisk AppleWorks 


would be much 

better if we could 

specify that some of 

the ram would be 

used by the ramdisk, 

and the rest would 

be used by the 

program. The partition utility will allow us to do this. 
_partitioning will allow us to specify a certain amount of 
ram to be used by AppleWorks for program and desktop 
space, while the rest is used for the ramdisk. No other 
programs that access extended memory are guaranteed 
to recognize the partition at this time, however several 
may. 


Only ramcards that use the RAM.DRIVE device 
driver are partitionable. These cards as well as those 
that do not are listed as follows: 


Partitionable Non-Partitionable 
AE Zram AE Ramfactor 
AE Ramworks Any GS Ram expansion 


Checkmate MultiRam Apple Ram Expansion 
If your card is non-partitionable, do not worry. Apple- 


Works 2.0+ will handle this problem by creating a file on 
the ram volume. All of the space in use by the file will 


57 


be dedicated to AppleWorks desktop, therefore avoiding 
crashing the ramdisk. If your card is partitionable then 
read on. 


In order for partitioning to work on your ramdisk, 
you must first use the expansion software that comes 
with your ramcard to give AppleWorks the capabilities 
needed to work with the additional ram. Both Applied 
Engineering and Checkmate supply expansion software 
to enhance any version of AppleWorks. If you have a 
version of AppleWorks below 2.0, we would recommend 
that you upgrade as soon as possible because of the 
bugs encountered in earlier versions. Be sure to use a 
backup copy of your original AppleWorks disk when 
doing the expansion. 


NOTE: DO NOT install any accessory software (ie. 


TimeOut or Pinpoint) for AppleWorks until 
after the partitioning process Is finished. 
Additionally whenever you change the parti- 


tion sizes you must start by expanding a fresh 
copy of AppleWorks. 


After you have expanded the AppleWorks soft- 
ware you may run the RAMUP partition utility. Follow 
these step-by-step instructions: 


1) Select Partition a RamCard from the RAMUP 
Utilities Menu. 
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2) In afew seconds a screen will appear that will 
ask for the disk that contains the RAM.DRIVE file 
(if you are running from 5.25" disks). This 
= file is normally found on the front side of 
the RAMUP program disk. Please insert 
this disk and press <RETURN>. 


3) The utility will read the previous partition data 
from the RAM.DRIVE driver and will display it on 
the screen with a graph. The left side of the 
graph represents how much expanded memory 
will be used by AppleWorks, and the right side of 
the graph will show how much room will be used 
by the ramdisk. Use the right and left arrow keys 
to adjust the partition sizes. 


4) When you are satisfied with the amount of ram 
that will be available to the ramdisk and to Apple- 
Works you may press the <RETURN> key to 
continue. 


5) At this point the ramdisk partition information will 
be written back into the file named RAM.DRIVE. 
-~s(ear] ~=—s In. a few seconds the partition 

a program will prompt you to insert 
the AppleWorks diskette. (If you 
are not partitioning AppleWorks you may press 
the <ESC> key to finish the partitioning process 
at this point). Please insert the backup of 


AppleWorks that you expanded with the ramcard 
expander software and press <RETURN>. 
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6) The partition program will scan the AppleWorks 
disk to determine whether it was expanded for an 
Applied Engineering card or a Checkmate card. 

It will then write the partition information to Apple- 
Works and display a success message. 


7) Before hitting any keys please insert the RAMUP 
utilities disk (this is the back side of the RAMUP 
program disk). You may then press any key to 
return to the RAMUP Utilities Menu. 


You may now install any accessory software that you 
might want to use with AppleWorks. 


Convert 3.0 Program 


This utility is supplied for the users of RAMUP 
3.0. It will allow you to convert the DATA.LIST and 
TITLES.DATA from the RAMUP 3.0 format into the new 
format used by RAMUP 4.0. You only need to use this 
utility if you have made extensive changes to the 
DATA.LIST and TITLES.DATA. DO NOT USE this 
utility if you only made minor or no changes to these 
files, USE the Add ‘rom RAMUP Database or Add an 
Undefined Program utilities to configure RAMUP. We 
have supplied this utility to make it easier for previous 
RAMUP users to get up and running with the new 
version of the software under their old configuration. 
However, we do not recommend you use this utility. 
When aconversion is done on a file many of the vital 
features of this new version of RAMUP will not be 
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activated. You will have to use Modify a Program to 
activate these features. 


NOTE: You must have the file format of your previous 
DATA.LIST and TITLES.DATA exactly as the 
RAMUP 3.0 manual states. If there are any 
errors or comment fields in these files this 
program will crash. Also you must have at 
least one window installed with 2 or more 
applications in that window. See your 
RAMUP 3.0 manual for more information 
regarding the file formats. 


~ Ca You will be prompted to insert your 
oe RAMUP 3.0 disk containing the 

“EES DATA.LIST and TITLES.DATA files. 
Insert this disk, (usually the front side of RAMUP 3.0) 
and press any key at the prompt. 





You will be presented with a menu containing a 
list of all of the applications in the file. Use the up/down 
arrow keys to highlight the applications. Use the right/ 
left arrow keys to mark/unmark each application you 
wish to convert. When you have finished selecting all of 
the applications to be converted press <ESC> to end 
selection. 


NOTE: _ If you don’t see any applications you wish to 
select from this list, make sure no applications 
are selected and press <ESC>. You will be 
returned to the RAMUP Utilities Menu. 
However, if you have made sure you selected 
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all the files to convert, answer <Y> and 
<RETURN> at the prompt to continue. If 
you've forgotten some files or marked one by 
accident, just answer <N> and <RETURN> 
and you will be returned to the selection 
process. 


This utility will now begin to convert the selected 
files from the DATA.LIST file into the new RAMUP 4.0 
format. Note, at one point during the conversion 


= Ga) 
wy i 


process, Conv .O program may ask 
you to insert the disk containing 
RAMUP.SYSTEM. This is found on the 









front side of the RAMUP program diskette. If you see 
this prompt, insert the correct disk and press any key to 
continue. If this utility finds a DATA.FILE already in 
existence, it will automatically append the selected 
applications to the current list. However, if no 


DATA.FILE was found, Convert a 3.0 program will 


create this file to enab:e you to run RAMUP. 


NOTE: 


Remember that you are creating or modifying 
DATA.FILE which can contain a maximum of 
26 listings. If you had a pre-existing 
DATA.FILE before using this utility, remember 
not to select any more than you have room for 
in the DATA.FILE. For example, if you had a 
pre-existing DATA.FILE with 20 applications 
installed, you cannot select any more than 6 
additional applications. In this case, if you 
were to select more than 6 applications, let's 
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say 8 applications, only the first six would 
show up on the Add an Application screen, 
while the other 2 applications would be 
hidden. 


Once the conversion and installation is complete, 
you will see a prompt on the screen which states the 
conversion was successful. Press any key and you will 
be returned to the RAMUP Utilities Menu. 


View the Help Files 


With this utility you have the ability to view the 
help files contained on the RAMUP disk. These files 
contain information about specific program setups like 
AppleWorks with the TimeOut series, or how to set up 
RAMUP with ProDOS 16. You may scan through the 
text backwards, as well as forwards, by using the up/ 
down arrow keys. When you have scanned through all 
of the text, you will be returned to the RAMUP Utilities 
Menu. 


Put RAMUP on other disk 
This utility is designed to help you easily install 
RAMUP on a 3.5" disk, hard disk, ramdisk, or ROM 


disk, by taking out the guess work involved in such an 
operation. 
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NOTE: 


Before you run this utility make sure you have 
a disk that has been formatted for ProDOS. 
This does not mean that the disk must be 
blank, but that ProDOS files can be copied to 
the disk. Also the disk must contain enough 
room to store the RAMUP program. If you 
are installing just the RAMUP program you 
will need about 140k. However, if you would 
like to install the RAMUP Utilities as well as 
the program, you will need about 280k. If you 
are using a battery backed ramcard, such as 
the Ramfactor with Ramcharger or GSRam 
with Ramkeeper, you MUST first FORMAT 
the ramcard and then use this utility. For 
more information regarding the disk format- 
ting process, consult your “Apple ProDOS 
Users Manual”. 


Please have the volume you wish to have 


RAMUP installed ontc in the computer before executing 


this utility. 


Select Put RAMUP on other disk from the 


RAMUP Utilities Menu. When the utility is finished 
loading, you will be presented a menu with the volumes 
on line. If the volume you wish to install RAMUP on is 
not shown on the screen, don’t worry, just insert the disk 
and press <R> to re-scan the volumes. Use the up/ 
down arrow keys to highlight the volume where RAMUP 
is to be installed and press <RETURN>. 
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NOTE: _ If you do not see the volume name on the 
screen of the disk you wish to install RAMUP 
on, even after you have inserted the disk and 
pressed <R>, the disk you inserted is not 
formatted for ProDOS. Consult your “Apple 
ProDOS Users Manual” for more information. 


You will be asked if you want ProDOS 8 installed 
along with RAMUP. This will enable you to boot up 
your computer from this volume. You will want to an- 
swer “YES” to this option if you have installed a newly 
formatted disk with no files or ProDOS, or if you are 
using a battery backed ramcard, such as the Ramfactor 
with Ramcharger or GSRam with Ramkeeper, this will 
make RAMUP bootable from that ramcard on power-up. 
However, if you are installing this on a disk that is al- 
ready bootable, you want to answer “NO” at this prompt. 
Appropriately answer <N> or <Y> at the prompt and 
press <RETURN>. 


This utility will now begin copying all of the files 
RAMUP requires to run from a ramcard. After these 
files are copied, you will be asked if you want the utili- 
ties also installed. Having the utilities installed on the 
same diskette is helpful and time saving, especially 
when you won't have to bother with continually swap- 
ping diskettes. However, if you answer “NO” this will 
save vital storage space. We recommend that you 
install the utilities on a hard drive or 3.5" disk installation 
and not on a battery-backed-up ramcard or ROMdisk. 
This is because if the ramcard ever loses power you will 
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lose the current configuration of both RAMUP and 
DATA.FILE, however, when using a diskette, the infor- 
mation cannot be easily lost without destroying the disk. 
Appropriately answer <N> or <Y> at the prompt and 
press <RETURN3>. 


After all of the files are installed you will be 
returned to the RAMUP Utilities Menu. 
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Appendix A 
ABOUT DATA.FILE AND DATA.BASE 


RAMUP provides a database that includes many 
popular ProDOS application definitions which RAMUP 
uses to load your ramcard. This database is the file, 
DATA.BASE, found on the second disk in the RAMUP 
package marked “DATA.BASE Distribution Disk.” This 
database takes up more than 55k of disk space and will 
probably contain definitions of many of the programs 
you will want to run with RAMUP. It also will undoubta- 
bly contain some definitions which you will have no 
need for. 


Because of this, RAMUP requires you to prepare 
your own customized database called a RAMUP 
DATA.FILE. By doing this you can save valuable space 
on the ramdisk and avoid menus cluttered with prompts 
for applications that are never used. DATA.FILE is a 
subset of RAMUP’s DATA.BASE which is loaded to 
your ramcard. You create and edit this subset, 
DATA.FILE, with the utilities found on the back side of 
the RAMUP program disk. 


Your customized DATA.FILE may contain a 
maximum of 26 application listings. If you wish to 
change DATA.FILE when 26 listings have previously 
been selected, you must first use “Delete a Program” to 
make room for the changes. 
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NOTE: 


lf you modify DATA.FILE through Add from 
Database, Delete a Program, Modify a 


Program, or Add an Undefined Program you 
must replace the ramcard copy of DATA.FILE 


with the modified copy. Cold booting and 
then restarting RAMUP will load the modified 
DATA.FILE to your ramcard. If you have a 
battery backed ramcard, you may use Filer to 
copy the modified DATA.FILE to your 
ramcard. 
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Appendix B 
Continuing To Use RAMUP 


RAMUP provides three methods to load your ramcard. 
They are: 


1) Selecting applications each time you load your 


ramcard. (See *Add an application). 


2) Using Auto-Load to load applications automati- 


cally on boot-up. (See Auto-Load Config). 


3) Using Backup/Restore to restore an image of a 
previous backup. (See Backup/Restore). 


Backup/Restore is by far the fastest option for regularly 
setting up a ramdisk configuration, but the others are 
provided to give maximum flexibility to all users. 


RAMUP will support a ProDOS compatible clock by 
displaying the date and time at the top of the screen 
while at the Main Menu. Many clocks require a special 
driver be installed on whatever disk you boot the ma- 
chine from. Most often this will be the RAMUP program 
disk. Please refer to your clock hardware manual for 
instructions on installing this driver on the RAMUP 
program disk. 
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Appendix C 
Setting Up AppleWorks 


If you are using a Zram, Ramworks, or MultiRam card, 
you must follow these steps when you prepare Apple- 
Works for use with the ramcard: 


1) Use a fresh backup copy of your AppleWorks 
master disk. 


2) Use the AppleWorks expansion software that 
comes with your ramcard to give AppleWorks the 
capability to use the additional ram. This soft- 
ware will allow AppleWorks to have a large 
desktop, printer buffer, and many other conven- 
iences only available with lots of ram. 


3) Use the partition utility from the Utilities Menu on 
RAMUP to mal.e sure that the expanded capa- 
bilities AppleWorks has will not steal memory 
from the ramdisk. This utility will allocate a 
certain amount of space to AppleWorks and the 
rest to the ramdisk. 


4) Add any accessory software that you might want 
to use with AppleWorks. These accessories 
include the TimeOut series and Pinpoint. These 
accessories should not be installed before doing 
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the above steps. 


Any time you want to change the partition sizes or 
expansion capabilities you should start over from step 
one of these instructions. Any time you change these 
items, start with a fresh copy of AppleWorks, and al- 
ways install the accessories last. 


When installing the TimeOut series of 
AppleWorks enhancements make sure that you set the 
"Location of TimeOut Applications" to the AppleWorks 
subdirectory on the ramdisk (this is normally 
/RAM/APPLEWORKS/). 


7) 


Appendix D 


Distribution Files 


This is a list of files that should be included on 
the diskettes you recieved with your RAMUP 4.0 


package: 


Files 
RAMUFP front side: 
/RAMUP 
PRODOS 
RAMUP.SYSTEM 
BASIC.SYSTEM 
/WORKSUB 
BACKUP 
RAM08.SYSTEM 
FILER 
QUIT.CODE 
RAM.DRIVE 


RAMUP back side: 
/RAMUP 
/WORKSUB 

HELP.DATA 
INSTALL.UNIHARD 
DELETE 
MODIFY 
ADD 
CONVERSION 
PARTITION 


Description 


ProDOS operating system file 
RAMUP startup program 
Applesoft BASIC 


Backup/Restore utility 
RAMUP launcher program 
Apple ProDOS filer program 
RAMUP auit routine 
Ramdisk driver 


AWP notes on RAMUP 
RAMUP installation program 
Delete an Application utility 
Modify an Application utility 
Add an Undefined Program 
Convert 3.0 Application utility 
Partition utility 


TZ 


Files ription 


RUTIL.SYSTEM Utility menu 


QUIT.CODE RAMUP auit routine 
ADD.DATABASE _ Add from Database utility 
HELP.FILES Used to read HELP.DATA 
Database distribution disk: 
/RAMUP 
/WORKSUB 
DATA.BASE RAMUP application database 
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Appendix E 
Technical Support 


If you are experiencing problems with your 
RAMUP program we have a technical support staff you 
can contact to receive free assistance. 


Before you call: 


1) Be sure your computer matches or exceeds the 
minimum requirements specified in the 
‘REQUIREMENTS’ section of this manual. 


2) If you are using a backup copy of RAMUP, be 
Sure that you have made a good copy. 


3) Make sure you have read the section of the 
manual that refers to the portion of the RAMUP 
program you ar2 having a problem with. 


i Manual 


‘ Quality 
:t| Computers 
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Se Technical Support 


Remember, if you have a problem with RAMUP, check 
your manual first, then call technical support. 
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Make sure you have this information ready when you 


call: 


1) 


Be sure you know what version of RAMUP you 
are using. You can find this number on the 
RAMUP Title Screen when you boot the RAMUP 
diskette. 


Be sure you know what type of machine you are 
using. It is also helpful to Know what revisions of 
ROM or motherboard you have, however the 
technicians will be able to determine this informa- 
tion if you do not know it. 


Be sure you know what type of ramcard you are 
using, and additionally what slot it is being used 
In. 


Be sure you know what additional cards you are 
using and what slots they are in. 


Be sure you know what software you are using 
RAMUP with. 


Be able to clearly and concisely describe the 
problem you are having. It may help for you to sit 
down with the program and write down the steps 
that you take when the program exhibits the 
problem. It may also be advantageous for you to 
call from a phone near your computer. In this 
way the technicians can step you through tech- 
niques and fixes while you are on the computer. 
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Knowing this information before you call will allow 
our technicians to quickly pinpoint the problem you may 
be having. They will try to answer your questions as 
quickly as possible, however, sometimes a problem 
might be too complicated to answer over the phone. In 
such a case they may ask you to send in your disks for 
closer inspection. 


Our technicians are not just there for problems. 
lf you want to use RAMUP in a way not explained in this 


manual, they may be able to suggest techniques to help 
you get the most from RAMUP. They will also be able 
to suggest an optimal hardware configuration for your 
needs when you are interested in upgrading your sys- 
tem. 


Who to contact: 
Quality Computers Technical Support 
15102 Charlevoix 
Grosse Pointe Park, MI 48230 


(313) 331-1115 10:00am - 5:30pm 
EST: Monday - Friday 
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